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ABSTRACT 

The  aim  of  this  thesis  is  to  design  and  implement  a 
graphic  subsystem  for  a  graphic  display  terminal  with  conic 
section  capabilities.  The  display  terminal  with  its  associ¬ 
ated  peripheral  hardware  is  connected  to  a  PDP-ll/SO  com¬ 
puter. 

The  basic  concents  and  design  principles  of  graphic  sys¬ 
tems  are  discussed.  A  brief  description  is  given  of  the 
particular  hardware  configuration  of  the  Conog raph i c - 1 2 
disolay  system  as  installed  at  the  Naval  Postgraduate 
School.  Concepts  incorporated  in  the  designed  implementa¬ 
tion  are  explained.  Recommendations  are  included  for  possi¬ 
ble  future  extensions  of  the  system's  caoab i 1 i t i es . 
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I.  INTRODUCTION 

The  purpose  of  this  thesis  is  to  desian  and  impletr’ent  a 
graphic  subsystem  for  a  graphic  display  terminal  with  conic 
section  capabilities.  A  literature  search  was  performed  to 
determine  the  desirable  features  of  a  graphic  system  and 
plausible  means  of  implementation.  The  resulting  imple- 


mented 

design  provides  the  applications  orogrammer  with  a 

1  i  b  r  a  r  y 

packaoe  of  general  ourpose  subroutines  which  con- 

St  rue  t 

the  commands  for  the  Conoaraohic-12  Interactive 

Graph i c 

Display  System. 

The  Conographic“12  Display  System^  as  installed  at  the 
Naval  Postgraduate  Schoolf  is  a  display  terminal  interfaced 
with  a  PDP-11/50  comouter.  The  terminal  system  includes  an 
alphanumeric  keyboards  special  program  function  keyboardf 
joystick,  and  extendeP  symbol  capability.  This  terminal 
draws  points,  straioht  lines,  characters,  circles,  arcs, 
ellipses,  and  conic  curves.  As  a  result,  major  reductions 
in  the  amount  of  data  reguired  to  draw  a  given  picture  are 
made  possible.  Data  compression  means  that  pictures  take 
less  CPU  time  to  manipulate,  significantly  less  storage 
soace,  and  substatially  less  time  to  transmit  from  comouter 
memory  to  display  oevice  f31. 
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II 


INTERFACE  DESIGN  CONCEPTS 


A.  UNIVERSAL  GRAPHIC  LANGUAGE 

One  of  the  major  obstacles  in  defining  a  aeneral  graphic 
subsystem  is  thatr  even  among  the  experts^  there  is  no  con¬ 
sensus  of  opinion  on  what  its  capabilities  should  be.  Many 
can  point  out  various  functions  which  they  would  like  to  see 
in  the  system/  but  each  person  desires  different  functions. 
The  one  point  on  which  most  do  agree  is  that/  at  this  time/ 
simplicity  is  more  imoortant  than  efficiency  in  a  graphic 
language.  Once  a  language  has  been  conceived  and  can  be 
used  by  a  wide  variety  of  oeoole/  then  the  efficiency  of  the 
language  can  be  extended. 

iliseman  says  it  is  a  mistake  fo  sa’v  t^at  "because  we  are 
dealing  witd  graphical  thinas/  there  is  a  need  to  invent  a 
new  language/  or  oerhaos  to  embellish  an  existino  one"C^]. 
rthat  is  needed  is  a  rich  1 anguaoe  able  to  express  and  mani¬ 
pulate  complex  data  structures.  The  task  of  generating  pic” 
tures  as  a  byproduct  is  easy?  the  complexity  in  graphics 
arises  from  the  problems  of  data  descriotion  and  task  coor¬ 
dination. 

William  Newman  claims  we  already  have  a  general  purpose 
graphic  language  in  FORTRAN  IV.  Most  proposed  graphics 
packages  are  based  on  FORTRAN  IV/  even  thouoh  it  is  not  a 
particularly  good  lanauaae  C6) .  It  nas  to  be  considered 


A 


universal  because  everyone  uses  it  [A1 .  Extrapolating  from 
this  arguement  anv  language  with  input/output  capabilities 
could  be  considered  a  general  purpose  graphic  language  if 
there  are  no  particular  reguirements  that  it  must  meet. 

Several  of  the  exoerts  believe  that  it  is  impossible  to 
define  a  universal  Graphics  language  only  because  graphics 
is  not  understood  well  enouoh.  For  instance^  we  do  under¬ 
stand  arithmetic  well  enough  so  nobody  guestions  the  useful¬ 
ness  of  a  universal  arithmetic  language.  Rosenfeld  suggests 
that  "we  can  inculcate  graphical  thinking  at  a  stage  as 
early  as  arithmetic  thinkino  is  now  inculcated^  and  let  the 
next  generation  design  the  universal  graphic  1  anguage "  { ]  . 

Wells  considers  set  theory  a  universal  graphic  language. 
Unordered  sets  appear  in  many  languages.  The  ordered  struc- 
tureSf  lists  and  arrays^  in  programming  languages  are  just 
the  seguences  of  set  theory;  the  procedures  are  the  func¬ 
tions  of  set  theory;  and  lines  are  naturally  considered  to 
be  sets  of  points.  Reliance  should  be»  wherever  oossible^ 
on  established  general  mathematical  symbolism  and  conven- 
•tions/  rather  than  considering  particular  extensions  to 
computer-oriented  languages  that  have  been  developed  with 
economics  of  machine  operation  as  a  prime  consideration. 
Languages  should  first  be  desioned  for  man-to-man 
c ommun i c a t i on >  with  concern  for  the  efficiency  or  implemen¬ 
tation  on  various  machines  coming  later  t^l  . 

Since  there  are  different  areas  of  graphics  with 
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different  requirements  oerhaos  it  would  be  more  practical  to 
define  these  areas  and  their  requirements.  The  different 
areas  of  graphics  include:  off-line  input/  recognition/  and 
scene  analysis?  interactive  input?  plotting  output?  line 
drawings?  and  shaded  pictures.  Most  applications  will  be 
concerned  primarily  with  one  of  these  graphic  areas  although 
some  applications  may  deal  with  a  combination  of  areas/  such 
as  the  field  of  interactive  design  which  uses  a  combination 
of  interactive  input  and  line  drawings.  The  specific  needs 
of  each  area  should  be  researched  and  defined.  Then  a 
language  can  be  designed  for  each  area  rather  than  attempt¬ 
ing  to  desian  one  language  for  all  Graphics  areas. 


B.  GOALS  OF  A  GRAPHIC  SYSTEM 

Graphic  terminals  are  particularly  well  adapted  •’o  the 
many  problems  which  do  not  yield  exact  solutions  by  a  given 
algorithm.  Such  problems  often  require  the  user's  direct 
intervention  at  different  stages  in  the  computation/  man- 
to-machine  dialogue/  in  order  to  obtain  satisfactory  solu¬ 
tions.  The  efficiency  of  such  a  dialogue  demands  a  rapid/ 
synthetic  representation  of  results  as  well  as  a  simple/ 
flexible/  and  convenient  means  of  intervention  at  the  user's 
disposal.  Graphic  terminals  allow  quick  visualization  of 


d i ag  r ams / 


graphs/  or  any  picture  which  would  be  far  more 


easily  interoreted  than  the  usual  tabulated  numerical 
results.  Moreover/  these  terminals/  being  eouipped  with 
joystick/  hardware  zoom/  and  alphanumeric  and  function  key¬ 
boards/  become  accessible  to  non-orogrammers  {21. 

Ease  of  use  is  one  of  the  principal  goals  of  a  graphic 
system.  Conseguent 1 y /  a  graphic  system  reouires  certain 
properties.  First/  concepts  linked  with  the  use  of  graphic 
terminals  have  to  be  clearly  set  aoart.  These  basic  con¬ 
cepts  must  appear  in  the  structure  of  the  application  pro¬ 
gram/  making  the  system  a  "guide  for  good  programming"  [2]. 
Second/  the  number  of  instructions  related  to  interactive 
graphics  should  be  as  small  as  possible.  The  goal  is  to 
make  the  user's  manual  a  handy  reference  guiae  rather  than 
an  in-depth  study. 

Few  general  purpose  graphic  systems  would  be  able  to 
satisfy  completely  all  the  reouirements  of  a  particular 
application.  Therefore*  an  applications  programmer  is 
freauently  obliged  to  develop  a  specific  system  which  con¬ 
tains  the  features  neeoed  to  resolve  his  own  particular 
problem.  In  the  graphic  subsystem  for  the  Conog raph i c- 1 2  an 
attempt  is  made  to  provide  as  broad  a  variety  of  general 
purpose  graphic  tools  as  is  needed  to  aive  the  applications 
programmer  access  to  all  ot  the  terminal's  capabilities. 
The  modular  nature  of  subroutine  calls  facilitates  modifica¬ 
tion.  This  includes  the  deletion  of  functions  which  through 
utilization  are  determined  to  be  non-useful/  as  well  as  the 


addition  of  new  functions  which  are  deemed  desirable 


For 


this  reason,  a 
cient  means  of 
tic  extension 
Boul  Her  t21  . 


list  of  subroutine  calls  becomes  a  more  effi- 
implementatinq  an  interface  than  the  "syntac* 
of  an  existing  language"  recommended  by 


C.  SOFTWARE  DESIGN 


The  software  suooort  required  to  utilize  graphic  devices 
such  as  the  Conoq r aph i c • 1 2 ,  include  machine-dependent 
transmission,  interrupt  handling  routines,  and  processors 
for  user-oriented  languages.  The  design  of  graphic  programs 
begins  with  an  evaluation  of  other  software  support  avail¬ 
able  to  the  computer  system  and  the  degree  of  interaction 
required  to  incorporate  the  graphic  devices  151. 

A  multi-level  design  approach  is  used  in  the  development 
of  graphic  software.  There  are  generally  considered  to  be 
four  levels.  Level  one  includes  subroutines  which  are 
dependent  on  the  hardware  characteristics  of  the  graphic 
device.  They  perform  primitive  operations.  Software 
developed  at  this  level  provides  the  basic  tools  for  pro¬ 
gramming  at  the  higher  levels.  Level  two  programs  combine 
the  facilities  available  from  the  operating  system  with  the 
hardware-oriented  programs  of  level  one.  This  combination 
provides  the  programs  and  user-oriented  languages  to  be  used 
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at  level  three.  Software  development  at  level  three 
includes  u se r “o r i en t ed  subroutines  which  are  capable  of 
organizing  buffer  and  file  management  routines/  and  can  for¬ 
mulate  graohical  instructions  and  data  transmission.  Level 
four  progamming  is  application  progams  which  are  directed 
toward  the  support  of  the  non-proorammer  fSl  . 

The  lowest  level  of  this  multi-level  design  is  illus¬ 
trated  in  this  project.  It  involves  efforts  to  provide  an 
efficient  interface  for  the  handling  of  signals  between  the 
computer  and  the  Graphic  devices.  Progressively  higher  lev¬ 
els  of  software  components  can  then  be  developed  to  increase 
the  productivity  and  utility  of  the  total  system. 

The  programming  activities  of  this  project  are  primarily 
in  the  category  of  level  one  software  design  -  primitive/ 
hardware -oriented  subroutines.  At  the  most  primitive  level/ 
subroutines  are  used  to  produce  the  object  code  which  is 
reguired  to  generate  images.  Examoles  include  code  to  plot 
a  ooint/  display  a  character/  draw  a  vector/  etc.  At  this 
level  all  the  parameters  are  device-oriented.  That  is/  the 
subroutines  work  with  the  parameters  reguired  by  the 
Conogr aph i c - 1 2 .  Using  other  subroutines/  the  screen  ooint 
coordinates  and  slope  values  are  converted  into  the  device- 
oriented  curve  parameters.  User-oriented  subroutines  con¬ 


vert  the  user's  coordinates  to  screen  coordinates 


III.  HARDWARE  ENVIRONMENT 


The  Conograph ic“12  Interactive  Graphic  Display  System 
includes  raster  scan  CRT  display^  alphanumeric  keyboards 
program  function  keyboards  joystick,  extended  symbol  capa¬ 
bility,  and  hardware  70om.  The  coordinate  system  inherent 
in  the  hardware  is  an  integer  address  soace  with  the  x  and  y 
coordinate  values  ranging  from  -A096  to  ^095.  The  hardware 
includes  scale  and  offset  registers  which  provide  the  capa¬ 
bility  of  varying  the  portion  of  address  space  which  is 
displayed  on  the  screen.  When  the  scale  factor  is  one  and 
the  offsets  are  zero,  the  x  coordinates  from  zero  to  2097 
and  the  y  coordinates  from  zero-  to  1556  are  visible  on  the 
sc  reen  . 

The  storage  tube  terminal  has  the  basic  capabilities  of 
displaying  vectors  and  alphanumeric  characters.  Once  writ¬ 
ten  the  display  remains  visible  until  erased.  It  is  not 
necessary  to  continually  regenerate  the  output  data  or 
refresh  the  screen.  The  picture  is  actually  drawn  on  the 
target  of  a  video  memory  utilizing  random  X-Y  deflection. 
The  target  of  the  video  memory  is  electronically  scanned  to 
produce  the  video  signal  which  the  raster  scan  CRT  displays. 
The  generator,  which  supplies  the  X-Y  deflection  signals, 
draws  conic  curves  in  response  to  digital  parameters  sup¬ 
plied  from  a  computer  t3). 


The  alphanumeric  keyboard  has  the  ability  to  generate 


all  two  hundred  fifty-six  8-bit  character  codes.  The  key¬ 
board  generates  one  hundred  twenty-eight  ASCII  character 
codes^  and  there  is  an  additional  key  to  force  the  parity 
bit  to  zero  or  one.  This  extends  the  range  of  codes  that 
may  be  generated  to  the  full  two  hundred  fifty-six.  The 
alphanumeric  keyboard  can  be  enabled/disabled  by  a  command 
from  the  user’s  proaram  in  the  host  computer.  When  enabled^ 
striking  a  key  generates  an  interrupt/  passing  the  keycode 
to  the  computer.  For  the  operation  of  various  additional 
keys  provided  on  the  keyboard/  reference  the  Conogr aoh i c - 1 2 
System  Reference  Manual  [3). 

The  proaram  function  keyboard  consists  of  thirty-two 
function  keys  which  produce  codes  that  mav  be  interpreted  by 
a  program  in  the  host  comouter.  The  resulting  action  is 
totally  dependent  on  the  proaram. 

The  joystick/  when  enabled  by  a  program/  provides  cursor 
positioning  control  directly  to  the  user.  A  program  may 
obtain  this  positional  information  by  reading  the  graphic 
display  terminal's  registers.  Other  information  obtainable 
from  the  registers  are?  offset/  scale/  dash  pattern/  dash 
freauency/  and  selected  intensity. 

The  hardware  zoom  is  completely  independent  of  any  pro¬ 
gram.  It  provides  the  user  with  the  caoabilitv  of  dynami¬ 
cally  scaling  and  positioning  the  displayed  picture  in  order 
to  view  a  select  portion. 

The  extended  symbol  capability  provides  the  possibility 
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of  having  soecialized  fonts  or  soecial  sets  of  synbols  for 
particular  aco 1 i c a t i on s  .  A  standard  ASCII  character  font  is 
provided.  It  is  implemented  in  a  RO^  which  is  addressed 
as  a  particular  range  of  the  terminal  's  memory.  lihen  the 
terminal  is  in  alphanumeric  mode  and  an  8-bit  character  code 
is  receivedf  execution  of  the  instructions  located  at  the 


address  indicated  by  the 

sun  of 

the 

contents  of 

the 

font 

base  register 

plus  the 

the 

8-bit 

character  code  i s 

Per¬ 

formed.  In  the 

standard 

ASCII 

character  font 

ROM, 

th  i  s 

first  instruction  is  "jump  to 

symbo 1 

sub  rout i ne " 

[li]  . 

Thus 

the  first  256  locations  in  the  font's  adoress  space  comprise 
a  jump  table.  The  symbol  subroutine  is  composed  of  short 
graphic  commanos^  thus  all  capabilities  of  the  terminal  are 
accessable  except  the  hardware  dash  pattern  and  selectable 
intensity.  All  addressina  within  a  font  is  relative  to  the 
value  in  the  font  base  reaister.  The  address  snace  of  a 
font  is  limited  to  ^0*^6  locations  starting  with  t^e  address 
in  the  font  base  reaister  Special  fonts  and  symbol 
sets  may  be  implemented  in  the  same  manner  as  that  just 
described  for  the  standard  ASCII  character  set.  The  partic¬ 
ular  font  to  be  utilized  is  selected  bv  setting  the  font 
base  register.  The  default  setting  of  the  font  base  regis¬ 
ter  is  the  ASCII  font. 
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IV.  CONIE  -  CONOGRAPHIC  INTERFACE  EFFORT 


The  Conograohic*!?  Interface  is  a  hierarchical  set  of 
subroutines  which  can  be  divided  into  four  general  areas: 
Direct  Graphics^  Virtual  Graphics^  A  1 ph anume r i c s  /  and  Con¬ 
trol  Routines.  The  routines  in  all  these  areas  provide  the 
user  interface.  This  is  where  the  functions  as  conceived  by 
the  user  are  translated  into  functions  which  are  acceptable 
to  the  computer.  To  provide  ease  of  use/  every  operation 
which  is  functionally  different  is  referred  to  by  a  separate 
subroutine  call.  Each  subroutine  call  and  its  arguements 
are  described  in  Aooendix  A  of  this  thesis. 


A.  INITIALIZING  AND  TERMINATING 


To  ensure  a  orooer  starting  seouence/  an  initializing 
routine  is  provided  and  must  be  called  before  using  any 
other  CONIE  routine.  The  initial  state  is  defined  by  the 
following  four  reouirements:  Cursor  and  beam  are  at  the  HOME 
position(lower  left-hand  corner);  Terminal  is  in  graphic 
mode;  The  scaling  is  set  to  unity  and  rotation  and  offset 
are  at  zero;  Character  size  is  set  to  two/  "normal"  condi¬ 
tion.  This  initializing  routine  opens  files;  therefore/  it 
must  not  be  recalled  prior  to  calling  the  terminating 
routine.  The  terminating  routine  closes  the  files. 


B.  DIRECT  GRAPHICS 


Direct  araohics  utilizes  the  coordinate  system  provided 
by  the  Conoa r aoh i c - 1 2  hardware.  Included  are  scalina  and 
offsetting.  The  facilities  for  utilizing  the  conic  section 
capabilities  are  orovided.  These  include  routines  to  draw 
curves  given  the  Points  and  slopes  uniquely  describing  the 
particular  curve  desired.  Curves  may  be  uniquely  defined 
by:  two  points  and  their  associated  slope  (see  figure  1)» 
three  ooints  and  the  slooe  associated  with  one  of  these 
points  (see  figures  2»3  and  or  three  points  where  the 
slope  at  the  intermediate  ooint  is  equal  to  the  slooe  of  the 
chord  joining  the  endpoints  (see  figure  5).  Also  included 
are  routines  for  drawing  circles»  ellipses^  and  quarters 
thereof.  These  figures  may  be  specified  by  their  center  and 
length  of  a*eSf  or  their  center  and  one  endooint  of  each 
axis  (see  figure  6). 

C.  VIRTUAL  GRAPHICS 

To  escaoe  the  size  constraints  of  the  terminal  screen^ 
the  concept  of  virtual  coordinates  was  imolemented.  The 
virtual  coordinate  system  is  an  imaginary  surface  bounded 
only  by  the  range  of  the  floating  ooint  numbers  of  the  com¬ 
puter  system  being  used.  The  user  may  construct  a  drawing 
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FIG  3 


FIG  4 
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FIG  5 


FIG  6 
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in  any  section  of  the  virtual  coordinate  system  that  is 
desired.  The  units  of  the  system  have  no  physical  dimen¬ 
sions  associated  with  them.  Such  a  dimension  may  be  arbi¬ 
trarily  assumed  at  the  user's  convenience.  Before  con¬ 
structing  the  drawing,  the  user  specifies  which  oortion  of 
the  virtual  coordinates  system  to  be  viewed  by  calling  a 
rout i ne . 

The  virtual  coordinate  system  facilities  are  similar  to 
those  available  with  direct  coordinates.  There  is  one  not¬ 
able  exception:  Virtual  coordinates  permit  distortion  -  that 
is,  the  X  and  Y  units  may  be  of  different  sizes.  This 
capability  is  not  available  with  direct  coordinates.  The 
distortion  capability  precludes  oermitting  lengths  as  param¬ 
eters  for  routines  (see  figure  7),  Therefore,  the  routines 
available  with  virtual  coordinates  are  only  a  subset  of 
those  available  with  direct  coordinates. 


D.  ALPHANUMERICS 

Capability  is  provided  for  sending  a  string  of  charac¬ 
ters.  A  character  strino,  as  defined  in  the  "C"  language 
[7],  is  any  number  of  characters,  excluding  the  null  charac¬ 
ter.  However,  the  null  character  must  be  included  at  the 
end  of  the  string  to  indicate  termination  of  the  character 
string.  A  string  of  characters  will  normally  be  interpreted 
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FIG  7 
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by  the  Conoqraph i c-1 2  as  belongina  to  the  ASCII  character 
setf  unless  a  different  set  of  symbols  has  been  defined  and 
the  font  base  register  has  been  loaded  to  point  to  this 
other  set  of  symbols. 

There  are  two  modes  for  sending  a  string  of  characters 
to  the  terminal.  The  difference  between  Template  Mode  and 
Alphanumeric  Mode  is  only  a  scale  factor  of  eight? 
a  1 ph anume r i c s  are  drawn  scaled  down  by  a  factor  of  eight. 

E.  CONTROL  ROUTINES 

There  are  various  control  routines  which  provide  for 
such  functions  as  re-initialization?  erasure?  ringing  the 
keyboard  bell?  selecting  dash  patterns  and  frequencies?  and 
setting  scale  factor,  angle  of  rotation,  center  of  rotation, 
and  reflection  bits.  Other  control  routines  provide  for  the 
reading  of  the  terminal's  reaisters,  keyboard  characters» 
and  the  program  function  keys.  A  control  routine  which 
utilizes  the  recursive  property  of  the  "C"  language  allows 
large  complex  structures  to  be  built  up  in  modular  fashion 
from  small  simple  structures  CIJ.  At  the  lowest  level  of 
complex  structures^  the  extended  symbol  capabilty  can  be 
utilized  to  further  simplify  the  building  of  structures. 
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V.  RECOMMENDATIONS 


An  assembler  or  very  oowerful  editor  for  building 
extended  symbol  sets  would  be  a  very  useful  extension  to  the 
present  implementation.  This  is  needed  to  assist  the  pro* 
grammer  in  building  the  jumo  table  with  the  proper 
addresses . 

The  addition  of  higher  level  routines  to  plot  arrays^ 
and  to  provide  cur ve- f i t t i ng  and  data  smoothing  is  recom¬ 
mended.  The  caoability  of  plotting  arrays  is  convenient  in 
a  variety  of  applications.  Cu r ve- f i t t i ng  and  data  smoothing 
combine  to  take  full  advantage  of  the  Conog r aph i c -  1 2  '  s  capa¬ 
bilities  so  that  data  comoression  can  be  fully  exoloited. 

The  different  graohic  disolay  terminals  at  the  Naval 
Postgraduate  School  have  uniouely  individual  hardware 
features.  However/  in  time  the  capabilities  provided  by 
their  software  systems  will  achieve  a  high  decree  of  over¬ 
lap.  At  that  time  it  will  be  feasible  to  design  and  imple¬ 
ment  a  pre“orocessor  extension  to  the  "C”  language  17]  which 
will  perform  the  translation  to  the  particular  routines  for 
the  graphic  disolay  terminal  selected  at  compile  time.  A 
program  can  then  be  written  which  can  be  executed  on  any  or 
all  of  the  different  graohic  disolay  terminals  simoly  by 


recomo i 1 i ng  [8] 


VI.  CONCLUSIONS 


The  Conograph i c ” I  2  Interface  Effort  has  been  designed 
and  implemented.  As  a  result  of  the  programming  effort 
involved  in  the  production  of  COMIE^  the  user  can  fully 
utilize  the  Conogr aph i c - 1 2  and  its  associated  peripheral 
hardware . 
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APPENDIX  A  -  USER'S  MANUAL 


A.  INTRODUCTION 

This  manual  lists  in  alohabetical  order  the  subroutine 
calls  used  for  sending  graohic  commands  to  the  Cono- 
graphic-12  terminal.  Prior  to  the  execution  of  a  program 
utilizing  these  calls>  the  terminal  should  be  turned  on  and 
placed  in  non-local  mode  utilizing  the  switch  orovided  on 
the  terminal's  alohanumeric  keyboard. 

The  various  graphic  facilties  available  are  curve  draw- 
ingf  scaling,  offsettino,  automatic  dash  pattern  for  draw¬ 
ing,  reflections,  variable  intensity,  and  rotation.  Also 
available  is  the  ASCII  character  font  and  the  capability  of 
defining  additional  fonts. 

To  utilize  the  various  subroutines  provided,  a  program 
is  written  using  costartC)  as  the  first  graphic  call  and 
cgfini()  as  the  last.  The  oarticular  picture  or  subpictures 
to  be  displayed  are  best  described  in  functions  defined  by 
the  user  utilizina  the  drawing  commands  such  as  cgline, 
comove,  cgelosa,  or  cgcr22.  There  are  a  variety  of  addi¬ 
tional  drawino  commands  from  which  the  user  may  select  those 
best  suited  to  his  needs.  Character  outout  intermixed  with 
drawing  commands  can  be  accomplished  simoly  by  using  the 
cgaloh  command.  If  the  convention  is  followed  of  utilizing 
a  seoerate  function  for  each  suboicture,  then  the  positonino 
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of  each  suboicture  can  be  easily  accomplished  using  commands 
like  cgdrawr.  This  also  simplifies  the  defining  of  subpic¬ 
tures  since  each  has  its  own  set  of  coordinate  axes.  Thus 
the  user  can  define  independent  objects  for  display  and 
later  accomplish  the  relatiye  oositioning. 

An  illustration  of  how  cgdrawr  may  be  utilized  is  in  the 
segmentation  of  a  disolay  object  into  its  comoonent  parts/ 
which  may  haye  their  own  symmetry,  A  simple  example  would 
be  the  wheel  of  a  vehicle.  For  such  a  case  a  user  would 
write  a  function  defining  a  wheel/  oerhaps  with  coordinates 
(0/0)  for  the  center  hub  of  the  wheel.  The  vehicle  body 
could  be  defined  in  a  seperate  function  with  the  coordinates 
(0/0)  Dossibly  at  one  of  the  corners  of  the  vehicle.  When 
drawing  the  comolete  vehicle  with  wheels/  the  sequence  of 
cqmove  followed  with  cgdrawr  would  be  utilized.  The  call  to 
camove  would  be  used  to  oosition  the  beam  at  the  end  of  the 
vehicle's  axle.  The  command  cadrawr  would  be  called  with 
the  wheel  function  and  the  proper  coordinates  of  the  wheel's 
center  as  defined  by  the  wheel  function  as  parameters.  This 
would  effectively  place  the  wheel  on  the  end  of  the 
vehicle's  axle. 

The  parameters  of  scale/  rotation/  and  reflection  for 
cgdrawr  provide  additional  flexibility.  With  the  scale 
parameter  available/  a  user  need  not  concern  himself  with 
making  the  units  uniform  for  all  suboictures.  Instead  he 
may  utilize  the  most  convenient  units  for  each  seperate 
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suboicture  and  then  scale  aoproDriately.  The  rotation 
parameter  enables  the  user  to  define  a  subpicture  at  the 
angle  where  its  coordinates  are  most  easily  exoressed#  and 
then  rotate  the  subpicture  to  provide  the  proper  display. 
The  reflection  parameter  provides  the  capability  for  exact 
90  degree  rotations  and  subpicture  inversions.  The  center 
for  all  of  these  transformations  is  the  beam  position  when 
the  cgdrawr  command  is  executed. 

Control  of  the  manner  in  which  input  coordinate  data  is 
to  be  interpreted  is  provided  by  the  subroutines  cginpfm  and 
cgvcord.  The  routine  cainofm  permits  the  user  to  declare 
whether  his  coordinate  data  will  be  expressed  in  normal 
Cartesian  coordinate  format  or  in  coordinates  relative  to 
the  beam  position.  The  routine  cgvcord  enables  the  user  to 
specify  a  floating  point  coordinate  system.  The  information 
the  user  provides  cgvcord  is  used  to  set  the  parameters 
necessary  for  converting  floating  point  coordinates  into  the 
integer  coordinate  system  of  the  screen. 

Additional  subroutines  orovide  control  of  various 
hardware  features^  some  of  which  are  as  simple  as  ringing 
the  keyboard  bell.  Others  orovide  the  input  of  information 
from  the  various  auxiliary  devices^  including  the 
alphanumeric  and  program  function  keyboards.  The  dash  pat¬ 
tern  and  selectable  intensity  are  controlled  by  the  routines 
cadofis  and  cgdsi.  The  routine  cadpfis  is  utilized  to  set 
the  pattern  and  intensity  available.  The  routine  cadsi  is 
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inserted  at  aoprooriate  places  in  the  drawing  commands  to 
turn  on  or  off  the  utilization  of  the  dash  pattern  or 
selected  intensity.  The  ability  to  erase  either  the  full 
screen  or  a  select  object  is  provided  by  cqerase.  In  order 
to  erase  a  particular  object/  cqerase  is  called  for  the 
appropriate  setting.  The  commands  for  drawing  the  object 
are  the  re-executed  to  accomplish  the  erasure/  after  which 
cqerase  is  recalled  to  reset  to  normal  drawing. 

The  user's  program  is  compiled/  specifying  that  the 
Conoqraphic-l2  library  be  included.  The  routines  available 
in  this  library  and  the  parameters  they  require  are  detailed 
on  the  following  pages.  The  naming  convention  followed  is 
that  all  start  with  the  letters  "eg"  so  that  the  user  can 
easily  avoid  collision  of  names.  Also  all  routines  using 
virtual  coordinates  start  with  "cav"  to  signify  that  their 
coordinate  parameters  are  virtual  and  must  therefore  be 
floating  point  numbers. 


B.  SAMPLE  PROGRAM 


//  This  program  draws  a  simple  sketch  of  a  ferris  wheel 

//  This  function  defines  the  labels  to  be  placed  on  each  car 
char  ^numlil 
i  n  t  i  ; 

sw i t  c  h  ( i  )  { 

case  0:  return!  "0"); 
case  1;  return!  ”1"); 
case  2:  return!"?"); 
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case 

case 

case 

case 

case 

} 


3: 
a : 
5: 
6: 
7: 


return("3") ? 
return(  "  ”  )  ; 
return("5'')  ; 
return( "b” ) ; 
return("7") ; 


//This  function  draws  the  car  and  calls  the  label  function 
ca  r ( i ) 
i  nt  if 
{ 

cgc i rc (Of  Of  5) ; 
cgelDsa(0f-5Of0,Of20f50)  ; 

cgmove(*5f-60);  //  Position  for  the  label 

cga 1 ph ( num ( i ) ) ;  //  Output  the  label 

> 


i  nt  if 

//  This  function  draws  the  arms  of  the  ferris  wheel 
//  and  positions  the  cars  at  their  ends 
a  rm ( a  f  b  ) 
i nt  a  f  b ; 

( 

cgelpsa(OfOfO.Ofafb); 

cgmove(afO);  //  Move  to  the  end  of  the  arm 

cgdrawaCl .OfO.OfOfOfOfCarf i fO); 

//  Set  an  upright  orientation  for  the  car 

//  This  is  the  main  program  which  initiates  and 
//  positions  the  picture  on  the  screen 
ma i n  (  ) 

{ 

cgstart (" ferri s")  ; 
cgc  r s  r ( 0  ) ; 
cgmove( 1023f800)f 

for(i=0;i<8;i++)  cgdrawr(1.0f0.39269fif0f0farmf500f50) 

//  Draw  the  arm  in  all  its  eight  reflections 
c  g  f  i  n  i  ( ) ; 

> 
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cqa 1 ph 


cqa 1 ph 


NAME: 

cgalph  -  emit  character  strinq  in  alphanumeric  mode 

SYNOPSIS: 

cqa 1 ph ( a ) 
char  a  []  » 


DESCRIPTION: 

This  routine  places  the  terminal  in  alphanumeric 
mode  and  then  sends  a  character  string  to  the  terminal. 
It  returns  the  beam  position  to  a  point  one  line  down 
from  the  previous  position  and  returns  the  terminal  to 
the  previous  graphic  mode. 

a  -  nu  1  1 -t  e  rm  i  na  t  ed  character  strinq  to  be  s.ent  to 
Conograohic-l? 


SEE  ALSO: 
cqtpl t 
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cgbe  1  1 


cgbe 1 1 


NAME: 

cgbell  ”  ping  keyboard  bell 
SYNOPSIS: 
cgbe 1 1  ( ) 


DESCRIPTION: 

This  routine  rings  the  keyboard  bell. 
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cqc i PC 


cqc 1  PC 


NAME: 

cgcipc  -  draw  a  circle 

SYNOPSIS: 

ccc i PC ( a / b / t ) 

i  nt  a  ^  b  » t ; 


DESCRIPTION: 

This  routine  draws  a  circle  when  given  the  center 
point  and  the  radius.  The  coordinates  of  the  center 
point  are  shown  by  a»b.  The  radius  is  defined  by  the 
value  of  t. 

a  -  X  coordinate  of  center 
b  -  y  coordinate  of  center 
t  -  radius  of  circle 


SEE  ALSO: 
cgc i rq 
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cqc i rq 


cqc i rq 


NAME  : 

cgcirq  -  draw  circle  quarters 
SYNOPSIS: 

cqc i rq ( a  »  b , dr  »  q, se ) 
int  arbrdr,q; 
float  *  se  f 


DESCRIPTION: 

This  routine  draws  Quarters  of  circles  when  given 
the  values  for  the  center  Doint»  a  point  on  the  circle^ 
the  direction  in  which  to  draw  from  this  points  and  the 
number  of  quarters  to  be  drawn.  The  present  position  of 
the  beam  defines  a  point  on  the  circle.  The  center 
point  is  given  by  the  coordinates  a^b.  The  direction  in 
which  to  draw  from  the  present  oosition  is  defined  bv 
dr.  The  number  of  quarters  to  be  drawn  is  shown  by  q, 
where  one  quarter  is  assumed  and  3  draws  a  full  circle. 
The  address  where  the  value  of  the  ending  slope  will  be 
returned  is  defined  by  se. 

a  -  X  coordinate  of  center 

b  -  y  coordinate  of  center 

dr  -  direction  of  drawing 

0 :  draw  clockwise 

1:  draw  counterclockwise 

q  -  number  of  additional  quarters 

0:  one  quarter  only 

I :  sem i -c i rc 1 e 

2:  two  additional  quarters^  total  three  quarters 

3:  fullcircle 

se  •*  address  of  floating  point  variable  where  endina  slope 
can  be  returned 


SEE  ALSO: 

\ 

CQC i rq 
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cgc  rs r 


CQC  PS r 


NAME: 

cgcrsr  •  turn  cursor  on  or  off 

SYNOPSIS: 

cqc  r s  r (o ) 
i  nt  Of 


DESCRIPTION: 

This  routine  enab  1  e  s /d  i  sab  1  e  s  the  joystick.  i/vhen 
enabled^  the  user  can  directly  control  the  positioning 
of  the  cursor  by  manioulating  the  joystick. 

o  •  action  flag 

0:  disable  the  joystick 

1:  enable  the  joystick 


SEE  ALSO: 
eg  r dc  s  r 
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cgc  r22 


cgc  r22 


NAME: 

cqcr22  -  draw  a  curve  given  2  points  and  2  slopes 

SYNOPSIS: 

cqc  r 22 ( X / y  f  sb  f  se ) 
i  n  t  X  »  y  ; 
float  sb / se  f 


DESCRIPTION: 

This  routine  draws  a  curve  when  given  two  points  on 
the  desired  curve  and  the  slopes  associated  with  these 
two  Points.  The  beginning  point  of  the  curve  is  the 
present  position  of  ♦•he  beam.  The  coordinates  x/y 
define  the  endooint.  The  slooe  of  the  beginning  point 
is  defined  by  sb.  The  slooe  of  the  endpoint  is  given  by 
se . 


X  -  X  coordinate  of  the  endooint 

y  -  y  coordinate  of  the  endooint 

sb  -  slooe  of  the  curve  at  the  beginning  point 

se  -  slope  of  the  curve  at  the  endpoint 


DIAGNOSTICS: 

The  ambiguous  case  of  parameters  sb=se  outputs  a 
message  to  the  standard  outputs  moves  to  the  specified 
endpointf  and  returns  a  negative  value. 

SEE  also: 

cgcr3b»  cqcr3e/  cqcr3i/  cqcr3m/  cgvcr22f  cavcr3bf 
cqvcr3e»  cqvcr3i,  cqvcr3m 
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cac  r3b 


cgc  r3b 


NAME: 

cgcr3b  •  draw  a  curve  given  3  points  and  beginning  slooe 
SYNOPSIS: 

cgc r3b (g / h , X / y , sb » se ) 
i  n  t  g ,  h  /  X  »  y ; 
float  sb »  *se  ? 


DESCRIPTION: 

This  routine  draws  a  curve  when  given  three  points 
and  the  slooe  at  the  beainning  point.  The  beginning 
point  is  defined  by  the  present  position  of  the  beam. 
The  coordinates  of  the  intermediate  point  are  given  by 
g/h.  The  endooint  is  shown  by  the  coordinates  x»y.  The 
slope  at  the  beginning  point  is  defined  by  sh.  The 
address  where  the  value  of  the  ending  slope  will  be 
returned  is  shown  by  se, 

g  •  X  coordinate  of  intermediate  point 

h  -  y  coordinate  of  intermediate  point 

X  -  X  coordinate  of  the  endpoint 

y  -  y  coordinate  of  the  endpoint 

sb  -  slope  of  the  curve  at  the  beginning  point 

se  -  address  of  floating  point  variable  where  ending  slope 
can  be  returned 


DIAGNOSTICS: 

If  the  parameters  describe  a  curve  with  an 
inflection  points  a  message  is  outout  to  the  standard 
output/  the  beam  is  moved  to  the  endpoint/  ana  a 
negative  value  is  returned, 

SEE  ALSO: 

cgcr22/  cgcr3e/  cocrSi,  cacr3m/  cavcr22/  cgvcr3b/ 
cgvcr3e/  cqvcr3i/  covcr3m 


38 


cgc  r3e 


cqc  r3e 


NAME: 

cgcr3e  •  draw  a  curve  given  3  points  and  ending  slooe 
SYNOPSIS: 

cgcr3e(q»h/X/y»se) 
int  g/h,x,y; 
float  se; 


DESCRIPTION: 

This  routine  draws  a  curve  when  given  the 
coordinates  of  three  points  and  the  slope  at  the 
endpoint.  The  beainning  point  is  defined  by  the  present 
position  of  the  beam.  The  intermediate  point  is  shown 
by  the  coordinates  g^h.  The  endpoint  is  defined  by  the 
coordinates  x,y.  The  slope  at  the  endpoint  is  given  by 
se . 

g  -  X  coordinate  of  intermediate  point 

h  -  y  coordinate  of  intermediate  point 

X  -  X  coordinate  of  the  endpoint 

y  •  y  coordinate  of  the  endpoint 

se  •  slope  of  the  curve  at  the  endpoint 


DIAGNOSTICS: 

If  the  parameters  describe  a  curve  with  an 
inflection  point/  a  message  is  outout  to  the  standard 
output/  the  beam  is  moved  to  the  endpoint/  and  a 
negative  value  is  returned. 


SEE  ALSO: 

cgcr22/  cgcr3b/  cacr3i/  cqcr3m/  cqvcr2?/  cgvcr3b/ 
cgvcr3e/  cgvcr3i/  cavcr3m 
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cgc  r 3 i 


cgc  p3 i 


NAME; 

cgcr3i  ”  draw  a  curve  given  3  points  and  intermediate 
s  1  ooe 

SYNOPSIS; 

cgcr3i (q»h,x»y»si »se) 
i nt  g,h , X ,yi 
float  s i / *se ; 


DESCRIPTION; 

This  routine  draws  a  curve  when  given  three  points 
and  the  slope  at  the  intermediate  point.  The  beginning 
point  is  defined  by  the  present  position  of  the  beam. 
The  intermediate  point  is  given  by  the  coordinates  g^h. 
The  endooint  is  deHned  by  the  coordinates  x,y.  The 
slope  at  the  intermediate  Point  is  given  by  si.  The 
address  where  the  value  of  the  ending  slope  will  be 
returned  is  shown  bv  se. 

g  -  X  coordinate  of  intermediate  point 

h  -  y  coordinate  of  intermediate  point 

t 

X  -  X  coordinate  of  the  endpoint 

y  -  y  coordinate  of  the  endpoint 

si  -  slope  of  the  curve  at  the  intermediate  point 

se  -  address  of  floating  ooint  variable  where  ending  slope 

can  be  returned 


DIAGNOSTICS: 

If  the  oarameters  describe  a  curve  with  an 
inflection  points  a  message  is  output  to  the  standard 
outoutf  the  beam  is  moved  to  the  endpointr  and  a 
negative  value  is  returned# 

SEE  ALSO: 

cgcr22#  cgcr3br  cacrSe#  cqcr3mf  cqvcr22f  cqvcrSb^ 


cgvcr3e»  cgvcr5i,  cgvcr3m 


cgc  r  3m 


cgc  r  3m 


NAME: 

cgcr3m  -  draw  a  curve  given  3  points  with  the 
intermediate  at  the  relative  maximum 

SYNOPSIS: 

cgcr3m(gfh,x,v,se) 
int  Q  f  h  t  X , y  r 
float  *se; 


DESCRIPTION; 

This  routine  draws  a  curve  when  given  three  points 
where  the  slope  at  the  intermediate  point  is  equal  to 
the  slope  of  the  chord  joining  the  endpoints.  The 
beginning  point  i s  defined  by  the  present  position  of 


the  beam. 

The  intermediate 

point 

i  s 

s  h  own 

by 

the 

coordi nates 

g ^  h  .  The  endpo i n  t 

i  s 

de  f i ned 

by 

the 

coordinates 

X  ,  y  ,  The  address 

where 

the 

value 

o  f 

the 

ending  slope  will  be  returned  is  shown  by  se. 
q  “  X  coordinate  of  intermediate  point 

h  -  y  coordinate  of  intermediate  point 

X  -  X  coordinate  of  the  endpoint 

y  “  y  coordinate  of  the  endooint 

se  •  address  of  floating  point  variable  where  endina  slope 
can  be  returned 

SEE  ALSO; 


cgc  r 22 » 

cgc  r 3b » 

cgcr3e»  cgcr3i » 

cgve  r22 / 

cgve  r 3b  > 

cave  r 3e  t 

cgve  r  3 i t 

cqvc  r 3m 

cgdD  f i s 


cgdp  f i s 


NAME: 

cgdpfis  -  set  dash  pattern  and  frequqncy  and  selectable 
intensity 

SYNOPSIS: 

cgdpf i s {p»  f  » i ) 

i nt  Pt  f  f  \  t 


DESCRIPTION: 

This  routine  sets  dash  pattern,  dash  frequency,  and 
selected  intensity  level.  Draw  commands  are  affected 
only  if  cgdsi  has  been  called  setting  dash  and/or 
intensity  select. 

o  -  12  bit  value  definina  dash  pattern,  I  specifies 

intensification  and  0  specifies  blanking;  for  example, 
07777  would  be  a  solid  line,  0  would  be  a  blank  line, 
05252  would  be  short  dashes,  077  would  be  long  dashes. 

f  -  ^  bit  value  (0-15),  this  controls  the  frequency  of 

the  dash  oattern  thus  determining  the  length  of  the  dash 
corresponding  to  each  bit  in  the  pattern  (note:  other 
scale  factors  do  not  affect  the  dash  oattern) 

i  -  ^  bit  value  (0-15),  sets  the  grey  scale  level  of  the 

selectable  intensity,  0  is  dimmest,  15  is  brightest,  and 
12  is  the  grey  scale  level  of  the  normal  intensity 


SEE  ALSO: 
cgdsi 


^3 


cgdrawa 


cgdrawa 


NAME: 

cgdrawa  •  set  new  orientation  for  user  function 
SYNOPSIS: 

cgdrawa(s»a/r»x,y,f,acrav) 
int(*f)()»ac/avfr»x»y; 
float  s»a; 


DESCRIPTION: 

This  routine  resets  the  orientation  then  calls  the 
user's  function  with  the  two  arauements.  Scaling  is  by 
means  of  the  Conog raph i c 7 1 2  hardware  registers  therefore 
limited  to  the  range  of  1/6^  to  63  63/6^.  Upon  return 
the  previous  orientation  is  restored.  The  user's 
function  f  is  defined  by  the  user  to  draw  whatever 
subpicture  he  desires.  The  parameters  ac  and  av  are 
passed  to  the  user's  function  so  that  it  may  have 
parameters.  If  more  than  two  parameters  are  desired^  or 
non-integer  parameters  are  desired/  the  two  parameters 
provided  can  be  used  to  pass  a  count  and  a  pointer  to  an 
array  of  parameters. 

s  -  scale  to  be  applied 

a  -  angle  of  desired  rotation  expressed  in  radians 

r  -  reflection  desired 

0:  no  reflection 

1:  reflect  about  x-axis 

2:  reflect  about  y-axis 

3:  reflect  about  both  axes/  (oi  rotation) 

reflect  about  pi/^  line 

5:  pi/2  rotation  counterclockwise 

6:  oi /2  rotation  clockwise 

7:  reflect  about  3/^i  oi  line 

X  -  X  coordinate  which  will  correspond  with  present  beam 
position  and  be  the  center  of  reflection  ana  rotation 

y  -  y  coordinate  which  will  correspond  with  present  beam 

position  and  be  the  center  of  reflection  and  rotation 

f  -  user  defined  function 


ac  •  first  arquement  for  user  ftjnction 
av  -  second  arquement  for  user  function 


SEE  ALSO: 


cqdrawrf  cgvdrwa»  cqvdrwr 


cqdraw  r 


cgdraw  r 


NAME: 

cqdrawr  -  set  orientation  relative  to  present 
orientation 

SYNOPSIS; 

cgdrawr(s»a»r»xcfyc»ffac#av) 
int  ( * f ) ( ) » ac / av » r , xc » yc  ; 
float  s, ai 


DESCRIPTION: 

This  routine  sets  a  new  orientation  relative  to  the 
present  orientation  then  calls  the  user's  function. 
Thus  the  reflectionSf  rotations  and  scaling  are 
cummulative.  For  best  results  it  is  recommended  that 
most  scaling  factors  be  If  if  the  hardware  scaling 
provided  here  is  insufficient  it  is  recommended  that 
virtual  coordinates  be  uti1i?ed.  Upon  return  the 
present  orientation  is  restored.  The  user's  function  f 
is  defined  by  the  user  to  draw  whatever  subpicture  is 
desired.  The  parameters  ac  and  av  are  passed  to  the 
user's  function  so  that  it  may  have  parameters.  If  more 
than  two  parameters  are  desiredf  or  non-integer 

parameters  are  desiredf  the  two  parameters  provided  can 
be  used  to  pass  a  count  and  pointer  to  an  array  of 
oa  r ame  t  e  r s  . 

s  -  scale  to  be  aoolied 

a  -  angle  of  desired  rotation  expressed  in  radians 

r  -  reflection  desired 

0 :  no  reflection 

1:  reflect  about  x-axis 

2:  reflect  about  y-axis 

3:  reflect  about  both  axeSf  (oi  rotation) 

^1 :  reflect  about  oi/^  line 

5:  oi/2  rotation  counterclockwise 

6:  oi/2  rotation  clockwise 

7;  reflect  about  3/^  pi  line 

X  -  X  coordinate  which  will  corresoond  with  present  beam 

position  and  be  the  center  of  reflection  and  rotation 

y  -  y  coordinate  which  will  correspond  with  present  beam 


position  and  be  the  center  of  reflection  and  rotation 
f  -  user  defined  function 
ac  ”  first  arpuement  for  user  function 
av  •  second  arguement  for  user  function 

SEE  ALSO: 


cgdrawaf  cgvdrwa»  cqvdrwr 


cgds  i 


cgds  i 


NAME: 

cqdsi  -  select  dash  and/or  intensity 

SYNOPSIS: 

cgds i (d> i  ) 
i  n  t  d  /  i  ; 

DESCRIPTION: 


This  routine  determines 
commands  are  to  be  dashed 
intensity.  This  routine, is 
cgpdfis  which  sets  the 
intensity  which  is  used. 


drawing 
0 ;  set 
1 :  set 


mode  selection 
solid  drawing 
dashed  drawing 


whether 
and/or  at 
used  in 


suseguent 
normal  or 


drawing 
Select  ed 


con  j  unc  t i on  with 


oarticular  oattern  and/or 


intensity  selection 
0:  utilize  normal  intensity  (12) 

1:  utilize  the  oresently  set  selectable 


intensity 


SEE  ALSO: 


cgpdf  i  s 


cge Ipsa 


cge Ipsa 


NAME: 

cgelpsa  -  draw  an  ellipse  given  center  and  axes  lengths 
and  or i ent  at  ion 

SYNOPSIS: 

cgelpsa(a/br  r^mj  ffrn) 
int  afb»mj^mn; 
float  r ; 

DESCRIPTION: 

This  routine  draws  an  ellipse  when  aiven  the  center 
pointf  lengths  of  the  two  axesf  and  the  orientation. 
The  center  point  is  given  by  the  coordinates  a^b.  The 
length  of  the  major  semi-axis  is  defined  by  maj.  The 
length  of  the  minor  semi -axis  is  defined  by  min.  For 
orientation.  the  anale  between  the  major  axis  and  the 
horizontal  is  given  bv  r  and  is  written  in  radians. 

a  -  X  coordinate  of  center 

b  -  y  coordinate  of  center 

r  -  angle  of  major  axis  orientation  with  resoect  to  the 
x-axis  expressed  in  radians 

mj  -  major  semi-axis  length 

mn  -  minor  semi-axis  length 


SEE  ALSO: 

cgelpse.  cgelosa.  cgveloQ 


cge lose 


cge 1 pse 


NAME: 

cgelpse  •  draw  an  ellipse  given  center^  one  axis  end  and 
other  axis  length 

SYNOPSIS: 

cgelDSe(a»b»xe»ye» la) 
int  a^b»xe»ye/lg; 


DESCRIPTION: 

This  routine  draws  an  ellipse  when  given  the  center 
point/  one  axis  endpoint  and  the  length  of  the  other 
semi-axis.  The  center  point  is  shown  by  the  coordinates 
a/b.  The  coordinates  of  the  axis  endpoint  are  given  by 
xe/  ye.  The  length  of  the  other  semi-axis  is  given  by 
Ig. 


a  -  X  coordinate  of  center 

P  -  y  coordinate  of  center' 

X  -  X  coordinate  of  one  semi -axis  endpoint 

y  -  y  coordinate  of  one  semi-axis  endpoint 

Iq  -  length  of  other  semi-axis 

SEE  ALSO: 

cgelpsa/  cgelpsa#  covelpa 
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cge 1 psq 


cge 1 psa 


NAME  : 

cgelpsq  -  draw  elliose  quarters 
SYNOPSIS: 

cge1psq(afb»xe»ye»q»se) 
int  a  tb  r  xe  f  ye  f  Qi 
float  *se ; 


DESCRIPTION; 

This  routine  draws  the  specified  number  of  quarters 
of  an  ellipse  defined  by  its  center  and  one  endpoint  of 
each  axis.  The  endinq  slooe  is  returned  in  se.  Present 
beam  position  is  taken  as  the  endooint  of  one  axis  and 
drawing  starts  .in  the  direction  of  the  other  axis 
endoo int, 

a  “  X  coordinate  of  center 

b  -  y  coordinate  of  center 

xe  •  X  coordinate  of  other  axis  endooint 

ye  •  y  coordinate  of  other  axis  endooint 

q  -  number  of  additional  quarters 
0;  one  Quarter  only 

1  :  sem i -e 11 i pse 

2:  two  additional  quarters^  total  three  quarters 

3:  full  elliose 

se  ”  address  of  floating  point  variable  where  endinq  slope 
can  be  returned  , 


SEE  ALSO: 

cgelpsa,  cge1ose»  cqveloq 
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cge  rase 


cgerase 


NAME: 

cgerase  ~  erase  screen 

SYNOPSIS: 

cgerase ( e  r  w ) 
i  n  t  e  f  w ; 


DESCRIPTION: 

This  routine  erases  the  screen.  There  are  two  means 
of  doing  this.  Full  screen  erase  or  a  selective  erase 
can  be  used.  In  a  selective  erase  the  item  to  be  erased 
is  redrawn  after  this  routine  is  called  to  effect  the 
erasure. 

e  ”  erase  screen  f  1  aa 

0:  do  not  full  screen  erase 

1:  full  screen  erase 

w  -  writ  ting  mode  flag 

0:  return  in  normal  writting  mode 

1:  return  in  selective  erasure  mode 
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c  a  f  i  n  i 


c  a  f  i  n  i 


NAME: 


cgfini  -  close  files 


SYNOPSIS: 


cgfini (fn) 
char  f n  [)  ; 

DESCRIPTION: 

This  rout i ne 
fn  -  filename  used 

SEE  ALSO: 


closes  all 
previously 


files  that 
when  ca 1 1 i 


cgs  t  a  r  t 


S3 


cgstart  opens, 
ng  cgstart 


cqhome 


cahome 


NAME: 

cghome  -  initialize 
SYNOPSIS: 
cghome ( ) 


DESCRIPTION: 


This  routine  oerforms  display 
cursor  in  lower  left-hand  corner 
si2e=2»  picture  scale=l»  and  rotati 
are  zeroed  and  terminal  is  in  graph 


i  n  i  t  i  a  1  i  z  a  t 
of  screen# 
on  angle=0. 
i  c  mode. 


SEE  ALSO: 
cgst  ar t 


ion  with 
character 
Offsets 


5a 


cgi no  f m 


eg  i  np  f  rn 


NAME; 

cginpfm  -  set  input  form 

SYNOPSIS: 

cgi nofm (o) 
i  nt  Of 


DESCRIPTION: 

This  routine  sets  the  mode  in  which  coordinate 
parameters  will  be  expressed.  They  may  be  expressed  in 
either  Cartesian  coordinates  (absolute)f  where 

coordinates  are  relative  to  a  fixed  oriainf  or  in 
relative  coordinatesf  where  the  beam  oosition  is  used  as 
the  origin  so  that  adjusting  one  point  also  adjusts  all 
subsequent  ooints. 

o  *  selection  indicator 

0:  absolute  coordinates 

1:  relative  coordinates 
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cqkbd 


cgkbd 


NAME: 

cqkbd  ”  enable/disable  keyboard 

SYNOPSIS: 

cgkbd ( e ) 
i  n  t  e! 


DESCRIPTION; 

This  routine  turns  the  alohanumeric  keyboard  on  and 
off.  It  is  autocrat  i  cal  1  y  called  by  cgrdkey  to  turn  the 
keyboard  on;  howeverr  the  user  must  utilize  this  call  if 
he  desires  the  keyboard  di sabl edaf ter  reading. 

e  -  ac  t i on  f 1 aq 

0;  disable  keyboard 

1:  enable  keyboard 


SEE  ALSO; 
cgrdkey 
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c  q  1  i  n  e 


1  ne 


col 


NAME: 

cqline  ”  draw  a  line 

SYNOPSIS : 

c  g  1  i  n  e  (  X  /  y  ) 
i  n  t  X  »  y  ; 

DESCRIPTION: 

This  routine  draws  a  line  from  the  oresent  position 
of  the  beam  to  the  endpoint  defined  by  the  coordinates 

X  /  y , 


X 

X  coordinate 

o  f 

the 

endpo 1 n  t 

y 

y  coordinate 

0  f 

the 

endpo 1 n  t 

SEE  ALSO: 
cgv 1 i ne 
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cgmove 


cqmo ve 


NAME: 

cqmove  -  position  cursor 

SYNOPSIS: 

cqmove ( X / y ) 
i nt  X / y ; 

DESCRIPTION: 

This  routine  moves  the  beam  to  the 
position  without  drawina. 

X  -  X  coordinate  of  the  endpoint 

y  -  y  coordinate  of  the  endooint 

SEE  ALSO: 
cqvmove 


indicated 
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cgpf  k 


cgpf  k 


NAME: 

cgpfk  -  enable/disable  program  function  keys 

SYNOPSIS: 

cgpfk (e) 
i  nt  e ; 


DESCRIPTION: 

This  routine  turns  the  program  function  keyboard  on 
and  off.  It  is  automatically  called  by  cgrdpfk  to 
enable  the  function  keys»  but  must  be  called  by  the  user 
when  he  desires  to  diable  the  function  keys, 

e  -  ac  t i on  f 1 ag 

0:  disable  orogram  -func  t  i  on  keys 

1:  enable  program  function  keys 


SEE  ALSO: 
cgrdpf  k 
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cgpoi nt 


cgoo i n  t 


NAME : 

cgpoint  -  draw  a  point 

SYNOPSIS: 

cgpo i nt ( X , y ) 
i  n  t  X  »  y ; 

DESCRIPTION: 

This  routine  draws  a  point  at  the  specified 
pos i t i on . 

X  -  X  coordinate  of  the  point 
y  “  y  coordinate  of  the  point 

SEE  ALSO: 
eg vpo i n  t 
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cardacc 


cgrdacc 


NAME: 

cgrdacc  -  read  accumulator 

SYNOPSIS; 

cgrdacc ( ac ) 
i  n  t  *  a  c  » 

DESCRIPTION: 

This  routine  reads  the  Conoaraph i c- 1 2  accumulator. 

ac  •  address  of  an  inteoer  variable  where  the  value  from 
the  accumulator  can  be  returned 

SEE  ALSO: 
cgrdreg 
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cardc  s  r 


cgrdcsp 


NAME: 

cgrdcsp  •  pead  cupsop  position 

SYNOPSIS: 

eg  Pdc  sr ( X  f  y) 
i n t  * X  f  *y ; 


DESCRIPTION: 

This  poutine  peads  the  Conoa Paph i c - 1 2  ppesent  cupsop 


position. 

An 

add  1 t i ona 1 

side  effect  is  that 

the  CUPSOP 

is  t u pned 
pead i ng . 

off 

D  r i 0  r  to 

p  e  a  d  i  n  g 

and 

t  u  pned 

on  a  f  t  e  p 

X  -  addpess 

o  f 

an  i n  t  eae  r 

va  p i ab 1 e 

where 

the  X 

coopdi nate 

can  be  petupned 

y  -  addpess 

o  f 

an  i n  t  ege  r 

va  p i ab 1 e 

where 

the  y 

coopdinate 

can  be  petupned 


SEE  ALSO: 

cgcpsp/  cgpdpeg 
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cardds w 


cgpddsw 


NAME : 

cqrddsw  -  read  display  status  word 

SYNOPSIS: 

cgrddsw(ds) 
i nt  *ds ; 


DESCRIPTION: 


This 

word. 


routine  reads 


the  Conooraphic 


12  display  status 


ds  •  address  of  an  integer  variable  where  the 
the  display  status  word  can  be  returned 


value  f  r  o<n 


The  bits  have  the  following  meanings  (low  order  bit  0) 
0  :  i  t  a  1  i  c  s 

1:  machine  check 

3:  pfk  reauestinq  attention 

7,6:  mode  of  the  display 

00  -  alphanumeric 

01  -  t  empl ate 

10  -  short  graph i c 

1  1  -  1 ong  graph i c 

10-8:  reflection  state 
11:  graphic  input  flag 

15:  TTY  switch  setting 


SEE  ALSO: 
eg  r d  r eg 
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cqrdfbs 


cgrd  f bs 


NAME: 

cgrdfbs  -  read  font  base 

SYNOPSIS: 

cgrdf bs ( f b ) 
i  n  t  *  f  b  ? 

DESCRIPTION: 

This  routine  reads  the  address  in  the  font  base 
register  for  the  memory  of  the  Conog r aph i c - 1 2 . 

fb  ”  address  of  an  integer  variable  where  the  address  from 
the  font  base  register  can  be  returned 

SEE  ALSO: 

cgrdmem^  cgwrmem,  cardrea 


6a 


ccjrdkey 


cgrdkey 


NAME: 

cgrdkey  •  read  keyboard  characters 

SYNOPSIS: 

cgrdkey(kfn) 
i  nt  n ; 
char  * k ; 


DESCRIPTION: 

This  routine  reads  a  specified  nunber  of 
fron  the  Conograph i c* 1 2  alphanumeric  keyboard 

n  -  number  of  characters  to  be  read 

k  -  character  array  of  at  least  size  n  where 
can  be  returned 

SEE  ALSO: 

cgkbd^  c'grdreg 


characters 


characters 
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eg  rdmem 


eg  rdmem 


NAME; 

egrdmem  •  read  memory 

SYNOPSIS: 

egrdmem(b»ri,w) 
i  n  t  b  »  n  f  *  w  ; 

OESCRIPTIOM; 

This  routine  loads  the  font  base  register  with  the 
suDolied  value  and  reads  the  speeified  number  of  words 
from  memo  r y . 

b  -  value  to  be  loaded  into  the  font  base  register 

n  -  number  of  words  to  be  read?  this  is  limited  to  the 

range  zero  to  4096 

w  -  array  of  at  least  size  n  where  the  words  from  memory 
can  be  returned 


SEE  ALSO: 

cgwrmem,  cgrdfbS/  cordreo 
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cgrdo f  f 


cgrdo  f  f 


NAME  : 

cqrdoff  -  read  offset 

SYNOPSIS: 

cgrdo f  f ( x , y ) 
i nt  *x / *y ; 


DESCRIPTION: 

This  routine  reads  the  current  Conograohic-l? 
offset. 

X  -  address  of  an  inteaer  variable  where  the  x  coordinate 
can  be  returned 

y  -  address  of  an  integer  variable  where  the  y  coordinate 
can  be  returned 


SEE  ALSO: 
cgrdreg 
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cgpdD  f  k 


cgrdp  f  k 


NAME: 

cgpdpfk  -  read  program  function  keys 

SYNOPSIS: 

cgrdpf  k ( k  f  n) 
i  n  t  n ; 
char  *  k  ? 


DESCRIPTION: 

This  routine  reads  a  specified  number  of  keycodes 
from  the  orogram  funtion  keyboard. 

n  -  number  of  keycodes  to  be  read 

k  -  character  array  of  at  least  size  n  where  keycodes  can 

be  returned 


SEE  ALSO: 

capfkr  cqrdreq 


/ 
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cgrdreg 


cgrdreq 


NAME: 

cgrdreg  -  read  all  the  registers 
SYNOPSIS: 
cgrdreg ( ) 


DESCRIPTION: 

This  routine  reads  all  the  Conoar  aph  i  c  ••  1  2  registers 
into  the  array  cgrea.  They  are  arranged  in  the 
following  order: 

0:  X  Dosition 

1  :  y  DOS i t i on 

2 :  X  offset 

3:  y  offset 

U :  object  scale 

5:  oicture  scale 

6 :  graoh i c  scale 

7:  font  base  register 

0:  display  status  word 

R :  ac  c  umu 1  a t  o  r 


SEE  ALSO: 

cgrdcsr/  cgrdoff#  cgrdscif  cqrdfbs»  cgrddsw/  cgrdacc 
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cqrdsc 1 


eg  r dsc 1 


NAME: 

cgrdscl  -  read  scales 
SYNOPSIS: 

egrdse 1 (p/o»q) 

int  *pf*Of*g; 


DESCRIPTION: 


This  routine  reads  the  scale  registers  of 
Conograph i c- 1 2 . 

the 

p 

-  address  of  an  integer  variable 

the  picture  scale  register  can  be 

where  the 
returned 

value 

from 

0 

”  address  of  an  integer  variable 

the  object  scale  register  can  be 

where  the 
returned 

value 

from 

g 

-  address  of  an  integer  variable 

the  graohic  scale  register  can  be 

where  the 
returned 

value 

f  r  om 

SEE  ALSO: 
cqrdreg 
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CQStart 


cgs  t  a  p  t 


NAME: 

cgstart  -  open  files  and  initialize 

SYNOPSIS: 

cgst  art ( f n) 
char  fnfj; 


DESCRIPTION: 

This  routine  must  be  called  prior  to  any  other.  If 
the  parameter  fn  is  presentf  an  output  file  is  created 
of  the  display  commands  that  follow?  otherwise  the  files 
associated  with  the  Conograph i c- 1 2  are  opened. 
Initialization  performed  by  this  routine  is  identical  to 
that  done  by  cghome. 

fn  -  filename  of  file  to  be  created  vice  writing  to  the 
Conograohic-12 


SEE  ALSO: 

cghomef  cafini 
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cat  p 1 1 


cqtpl t 


NAME: 

cgtolt  -  emit  character  string  in  template  mode 

SYNOPSIS: 

cgtpl t (a) 
char  a  tl  f 


DESCRIPTION: 

This  routine  places  the  terminal  in  template  mode 
and  then  sends  a  character  string  to  the  terminal.  It 
returns  the  beam  position  to  a  ooint  one  line  down  from 
the  previous  oosition  and  returns  the  terminal  to  the 
previous  oraohic  mode. 

a  •  nu 1 1 -t e rm i nat ed  character  string  to  he  sent  to 
Conograohic*12 


SEE  ALSO: 


cga 1  oh 


cgvcord 


cqvcopd 


NAME: 

cgvcord  •  define  virtual  coordinates 
SYNOPSIS: 

cgvcordC 1 x/ 1 y#  rx, ry^d) 
i  nt  d; 

float  lx»ly/rx»ry; 


DESCRIPTION: 

This  routine  defines  the  virtual  coordinates  by 
soecifing  the  lower-left  point  of  the  screen  and  the 
upper-right  point  of  the  screen.  Virtual  coordinates 
are  still  affected  by  scalino  and  offset.  Definition  of 
the  virtual  coordinates  with  respect  to  the  screen 
assumes  a  unity  scaling  and  zero  offset. 


lx  - 

minimum 

X 

V  i  r  t  ua  1 

coordinate 

on 

the 

sc  r een 

ly  - 

mini  mum 

y 

V  i  r  t  ua  1 

coordi nate 

on 

the 

sc  reen 

r  X  - 

maxi  mum 

X 

V  i  r  t  ua  1 

coordi nate 

on 

the 

screen 

ry  - 

maxi  mum 

y 

V  i  r  t  u  a  1 

coordinate 

on 

the 

screen 

d  -  distortion  flaa 

0 :  do  not  distort 

1:  oemit  distortion 
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cgvc  r22 


cgvcr22 


NAME: 

cgvcr22  -  curve  given  endooints  and  slooes 
SYNOPSIS: 

cgvcr22(x»y/sb^se) 
float  Xfy,sb»se; 


DESCRIPTION: 

This  routine  draws  a  curve  when  given  two  points  on 
the  desired  curve  and  the  slooes  associated  with  these 
two  points.  The  beginning  ooint  of  the  curve  is  the 
present  position  of  the  beam.  The  coordinates  x,y 
define  the  endpoint.  The  slooe  of  the  beginning  point 
is  defined  by  sb.  The  slope  of  the  endpoint  is  given  by 
se . 


X  -  X  virtual  coordinate  of  the  endpoint 

y  -  y  virtual  coordinate  of  the  endpoint 

sb  -  slooe  of  the  curve  at  the  beginnina  point 

se  -  slooe  of  the  curve  at  the  endpoint 

SEE  ALSO: 


cgc  r22 , 

cgcr3b»  cacr3e» 

cac  r  3 i » 

cac  r  3m / 

cgvc  r 3e  f 

cgvc  r 3 i , 

cgvc  r  3m 

7a 


cgvc  r3b 


CQvc  r 3b 


NAME : 

cgvcr3b  -  curve  given  three  points  and  beginning  slope 
SYNOPSIS: 

cgvcr3b(g,h,Xfy,sb»se) 
float  g# h r X » y , sb f *se; 


DESCRIPTION; 


This  routine  draws  a  curve  when  given  three  points 
and  the  slope  at  the  beainninq  point.  The  beginning 
point  is  defined  by  the  present  position  of  the  beam. 
The  coordinates  of  the  intermediate  point  are  given  by 
g/h.  The  endpoint  is  shown  by  the  coordinates  x/y.  The 
slope  at  the  beginning  point  is  defined  by  sb .  The 
address  where  the  value  of  the  ending  slope  will  be 
returned  is  shown  by  se. 


g 

h 

X 

y 


X  virtual 
y  virtual 
X  virtual 
y  virtual 


coordinate  of 
coordi nat  e  of 
coordinate  of 
coordinate  of 


intermediate  point 
intermediate  point 
the  endpoint 
the  endpo i nt 


sb  -  slope  of  the  curve  at  the  beainning  point 


se  ”  address  of  floatina  point  variable  where  endina  slope 
can  be  returned 


SEE  ALSO: 


cgc  r22 / 
cgvc  r 3e » 


cgc  r  3b » 
cgvc  r3i , 


cgc  r 3e » 
cgvc  r 3m 


cgcr3i , 


cacr3m/  cgvcr22/ 


i 
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eg VC  r 3e 


cgve  r 3e 


NAME: 

cqvcr3e  -  curve  given  three  points  and  ending  slope 
SYNOPSIS: 

cgvcr3e(g»h, x,y,se) 
float  g,h, XfY, sei 


DESCRIPTION: 


This  routine  draws  a  curve  when  given  the 
coordinates  of  three  points  and  the  slope  at  the 
endpoint.  The  beginning  point  is  defined  by  the  present 
position  of  the  beam.  The  intermediate  point  is  shown 
by  the  coordinates  q^h.  The  endpoint  is  defined  by  the 
coordinates  x,y.  The  slope  at  the  endpoint  is  given  by 
se . 


g 

h 

X  - 

y 

se  - 


X  virtual 
y  virtual 
X  virtual 
y  V i r t  ua 1 
slope  of 


coordinate  of 
coordinate  of 
coordinate  of 
coordinate  of 


i n  t  ermed i ate 
i nt  e  rmed i at  e 
the  endpoint 
t  he  endpo i n  t 


the  curve  at  the  endpoint 


point 

point 


SEE  ALSO: 


ege  r22, 

cgvcr3b» 


ege  r 3b  f 
cgve  r 3 i , 


cac  r 3e  r 

cove r 3m 


cqc  r  3 i f 


cqcr3m,  cgvcr22. 
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cqvc  r3 i 


cgvc  r  3 i 


NAME: 

cavcr3i  •  curve  given  three  points  and  intermediate 
s  1  ope 

SYNOPSIS: 

cgvcr3i (g»h/x,y,si »se) 
float  g#h,x,y,si»*se; 


DESCRIPTION: 


This  routine  draws  a  curve  when  given  three  points 
and  the  slope  at  the  intermediate  point.  The  beginning 
point  is  defined  by  the  present  position  of  the  beam. 
The  intermediate  point  is  qiven  by  the  coordinates  g»h. 
The  endooint  is  defined  by  the  coordinates  x^y.  The 
slope  at  the  intermediate  point  is  given  by  si.  The 
address  where  the  value  of  the  ending  slope  will  be 
returned  is  shown  by  se. 


g 

h 

X 

y 


X  virtual 
y  virtual 
X  virtual 
y  virtual 


coordinate  of 
coord i nat  e  of 
coordinate  of 
coordinate  of 


intermediate  point 
intermediate  point 
the  endpoint 
the  endooint 


si  ”  s 1 ooe  of  the  curve  at  the  intermediate  point 


se  -  address  of  floating  point  variable  where  ending  slope 
can  be  returned 


SEE  ALSO: 

cacr2?/  cgcr3bf  cgcr3e»  cgcr3i,  cacr3m,  cavcr22» 
cgvcr3e»  cgvcr3m 
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cgvc  p3m 


cgvc  r  3m 


NAME: 

cgvcr3m  -  curve  given  three  Doints^  one  at  the  relative 
maximum 

SYNOPSIS: 

cgvcr3m(gfh,x,y,se) 
float  g/h,Xfyr*seJ 


DESCRIPTION: 

This  routine  draws  a  curve  when  given  three  points 
where  the  slooe  at  the  intermediate  point  is  eoual  to 
the  slope  of  the  chord_  joining  the  endooints.  The 
beginning  point  is  defined  by  the  present  position  of 


the  beam. 

The  1 nt ermedi at  e 

Point 

1  s 

shown 

by 

the 

coordi nates 

g»h.  The  endpoint 

1  s 

defined 

by 

the 

coordinates 

XfV.  The  address 

where 

the 

value 

o  f 

the 

ending  slooe  will  be  returned  is  shown  by  se. 


g 

h 

X 

y 

se 


c  an 


X  virtual 
y  virtual 
X  virtual 
y  virtual 


coord i nat  e 
coord i na  t  e 
coordinate 
coordinate 


address  of  floating 
be  returned 


of  intermediate  point 
of  intermediate  point 
of  the  endpoi nt 
of  the  endpo i nt 

point  variable  where  endinq  slope 


SEE  ALSO: 

cgcr22r  cgcr3bf  cgcr3e»  CPcr3i#  cqcr3m/  cavcr22» 
cgvcr3ef  cgvcr3i 
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cqvdrwa 


cgvdrwa 


NAME: 

cgvdrwa  -  set  orientation  in  virtual  coordinates 
SYNOPSIS: 

cgvdrwaCSfa^  r,x  ty ,  ffac^av) 
int  {*f)()»ac/av»r; 
float  s  f  a  f  %  t  y  7 


DESCRIPTION: 


This  routine  resets  the  orientation  then  calls  the 
user's  function  with  the  two  arguements.  Scaling  is  by 
means  of  the  Conog r aoh i c “ 1 2  hardware  registers  therefore 
limited  to  the  range  of  1/6^1  to  63  63/6^.  Upon  return 
the  previous  orientation  is  restored.  Thus  the  user  is 
provided  with  a  convenient  means  of  recursively  stacking 
the  scale  and  offset  settings. 

s  -  scale  to  be  aoolied 


r  • 


angle  of  desired  rotation  expressed  in  radians 
reflection  desired 


0: 

no  reflection 

1 : 

reflect 

about 

X  -  a  X  i  s 

2: 

reflect 

about 

y  -  a  X  i  s 

3: 

reflect 

about 

both  axes  r 

(d  i 

rotation) 

a: 

reflect 

about 

p  i  /  line 

5: 

p  i  /2  rotation 

counterclockwise 

6: 

oi/2  rotation 

clockwise 

7: 

reflect 

about 

3 / ^  pi  line 

-  X 

V  i  r  t  u  a  1 

coordinate  which 

W  1 

1 1  correspond 

with 

present  beam 

position  and  be 

the 

center  of 

reflect 

1  on 

and 

rotation 

-  y 

V i r t  ua 1 

coordinate  which 

W  1 

1 1  correspond 

w 

i  t  h 

present  beam 

position  and  be 

the 

center  of 

reflect 

1  on 

and  rotation 


f  -  user  defined  function 

ac  -  first  arguement  for  user  function 

av  •  second  arguement  for  user  function 
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SEE  ALSO 


cgvd  rw  r  f 


cgdpawa , 


c  ad  r aw  p 


00 


cgvd  rw  r 


c  g vd  r w  r 


NAME: 

cgvdrwr  -  set  orientation  relative  to  present 
orientation  in  virtual  coordinates 

SYNOPSIS: 

cqvdrwr(s^a»rrx,yff,ac^av) 

int  (*f)()/ac/av/r?" float  s^arXry; 


DESCRIPTION: 

This  routine  sets  a  new  orientation  relative  to  the 
present  orientation  then  calls  the  user's  function. 
Thus  the  reflections^  rotations  and  scaling  are 
cummu 1  a t i ve .  For  best  results  it  is  recommended  that 
most  scaling  factors  be  if  the  hardware  scaling 

provided  here  is  insufficient  it  is  recommended  that 
scaling  be  effected  by  utilizing  another  call  to  cgvcord 
(note:  there  is  not  automatic  stacking  of  cgvcord 

settings).  Upon  return  the  present  orientation  is 
restored. 

s  -  scale  to  be  aoolied 

a  -  angle  of  desired  rotation  expressed  in  radians 
r  •  reflection  desired 


0: 

no  reflection 

1 : 

reflect 

about 

X -a  X i s 

2: 

reflect 

about 

y-a X  i  s 

3: 

reflect 

about 

both  axeSf 

( D  i 

rotat ion) 

a: 

reflect 

about 

p i /y  line 

5: 

pi /2  rotation 

counterclockwise 

6: 

pi /2  rotat i on 

clockwise 

7: 

reflect 

about 

3 / A  D i  line 

*  X 

V i r  t  ua 1 

coordinate  which 

w  i 

1  1 

c  o  r  respond 

with 

present  beam 

position  and  be 

the 

center  of 

reflection 

and 

rotation 

-  y 

V i r  t  ua 1 

coordinate  which 

w  i 

1 1 

correspond 

with 

oresent  beam 

position  and  be 

the 

center  of 

reflection 

and  rotation 

f  -  user  defined  function 


01 


ac  "  first  arpuement  for  user  function 
av  -  second  arguement  for  user  function 

SEE  ALSO: 


cqvdrwa#  cgdrawa^  codrawr 


cave  1 pq 


cqvel po 


NAME: 

cgvelpq  -  draw  ellipse  quarters  in  virtual  coordinates 
SYNOPSIS: 

cgvelpqla/bfxefvefOfSe) 
i  nt  q? 

float  arbf xe^ ye/ *se; 


DESCRIPTION: 

This  routine  draws  the  soecified  number  of  quarters 
of  an  ellipse  defined  by  its  center  and  one  endpoint  of 
each  axis.  The  ending  slooe  is  returned  in  se.  Present 
beam  position  is  taken  as  the  endpoint  of  one  axis  and 
drawing  starts  in  the  direction  of  the  other  axis 
endpo i nt . 

a  -  X  virtual  coordinate  of  center 

b  ”  y  virtual  coordinate  of  center 

xe  -  X  virtual  coordinate  of  other  axis  endpoint 

ye  -  y  virtual  coordinate  of  other  axis  endpoint 

q  -  number  of  additional  Quarters 
0:  one  quarter  only 

1:  semi-ellipse 

2:  two  additional  Quarters/  total  three  Quarters 

3:  full  ellipse 

se  “  address  of  floating  point  variable  where  endinq  slope 
can  be  returned 


SEE  ALSO: 

cgelosa/  cgelpse/  cqelosq 


03 


cgv 1 i ne 


cgv 1 i ne 


NAME: 

cgvline  -  line  in  virtual  coordinates 

SYNOPSIS: 

cgvl ine(x»y) 
float  X  f  y ; 


DESCRIPTION: 

In  this  routine  the  beginning  point  is  defined  as 
the  present  position  of  the  beam.  The  endpoint  is 
defined  by  the  coordinates  x,y. 

X  -  X  virtual  coordinate  of  the  endpoint 

y  -  y  virtual  coordinate  of  the  endpoint 


SEE  ALSO: 
c  g  1  i  n  e 


aa 


cgvmove 


cgvmove 


NAME: 

cgvmove  -  move  in  virtual  coordinates 

SYNOPSIS: 

cgvmove ( X , y ) 
float  X  f  y ; 

DESCRIPTION: 


This  routine  moves 
position  without  drawing 

• 

the 

beam 

to  the 

indicated 

X  virtual  coordinate 

of 

the 

endpo i 

n  t 

y  virtual  coordinate 

o  f 

the 

endpo i 

n  t 

SEE  AbSO: 
cgmove 
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cgw  rmem 


cgwrmem 


NAME: 

cgwrmem  -  write  to  memory 

SYNOPSIS: 

cgw  rmem (b / n  #  w ) 
int  bfn»*w; 

DESCRIPTION: 

This  routine  writes  the  specified  number  of 
into  the  Conog r aph i c - 1 2  font  memory  starting 
supplied  base  address. 

b  -  value  to  be  loaded  into  the  font  base  register 

n  -  number  of  words  to  be  written 

w  -  array  of  at  least  size  n  where  the  words  for 
are 


SEE  ALSO: 
cgrdmem 


words 
at  the 


memory 
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